home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Source Code / Add-Ons / MPW / MPW dmake 4.0 / readme / apple.mac next >
Encoding:
Text File  |  1995-12-05  |  3.3 KB  |  86 lines  |  [TEXT/MPS ]
  1. 05Dec95
  2.  
  3. Made error messages MPW style and added modified versions of Apple's
  4. BuildProgram and BuildCommands scripts. These scripts first search in the following
  5. order:
  6.  
  7.  - {program}.mk        (Target specific Makefile using dmake)
  8.  - {program}.make    (Target specific Makefile using MPW Make)
  9.  - Makefile.mk        (General Makefile using dmake)
  10.  - Makefile            (General Makefile using MPW Make)
  11.  
  12. The build is still 68K only, without a commando resource, and somewhat rough, but
  13. has worked very reliably for me. To install, simply copy dmake, BuildProgram and
  14. BuildCommands to some directory in the {Command} path.
  15.  
  16. 18Sep95    
  17.  
  18. I did a few changes to the original distribution. I'll contact the author later
  19. and plan to do some more work on dmake.
  20.  
  21. Matthias Neeracher
  22. neeri@iis.ee.ethz.ch
  23.  
  24. -------------- ORIGINAL RELEASE NOTES -------------
  25.  
  26. MAC specific information for dmake.  This information is provided in the
  27. hope that it makes it easier to install and recompile dmake in a MAC
  28. environment.  I do not own a Mac (and never wish to).  As a result I rely
  29. on others to insure that this version of dmake works as advertized.  If you
  30. have any problems with it please fix them and send me the differences so that
  31. I can incorporate them into future releases and patches.
  32.  
  33.  
  34. 1. ENVIRONMENT VARIABLE SETTINGS
  35.  
  36. Only a single set of settings is available for the macintosh.  There are no
  37. sub-selections for specific OS release and/or environment.
  38.  
  39.    OS         - mac
  40.    OSRELEASE     - NULL
  41.    OSENVIRONMENT - NULL
  42.  
  43.  
  44. 2. IMPLEMENTATION NOTES
  45.  
  46. This port for the Macintosh is specifically designed to be run
  47. under MPW.
  48.  
  49. I had to make a couple of changes to dmake in order to get it to work
  50. on the Mac.  First, MPW provides no documented way to run a
  51. subprocess, so when you use dmake, you MUST use the -n option and
  52. execute the output.  Typically, you will probably want to write a
  53. simple script file to do these operations for you.
  54.  
  55. I added some code so that the Macintosh version of dmake can
  56. use UNIX-style directories to specify include paths and target
  57. and dependency file names.  I.e., if you specify a file "/dir/file",
  58. dmake will look at the file "dir:file".  However, Mac dmake does not
  59. do any translation from files specified by UNIX-style directories
  60. in the recipe line that gets executed.  If you need to translate,
  61. you can use substitution commands.  (For example,
  62. ":$(RELATIVEUNIXFILE:s,/,:,)".)  This code was added so one could
  63. execute dmake's makefile, and also so one would have an easier time
  64. porting other UNIX makefiles.  I would suggest you stick with
  65. Macintosh-style directories for all other makefiles.
  66.  
  67. I was getting memory trashing errors when I was reading in
  68. environmental variables >4K with the -e option.  I had trouble
  69. tracking down exactly what was causing the problem, so decided it
  70. was easier to just clip the length before sending it to the dmake
  71. parser.  I arbitrarily picked 1K as the maximum length, figuring
  72. it was highly unlikely anyone really needed a variable longer than
  73. that from within a makefile.  (This error may be related to the
  74. value you set for MAXLINELENGTH, so to be safe, you should keep
  75. it >1K.)
  76.  
  77. In order to run dmake, you must set (and export) the environmental
  78. variable "OS" to "mac".
  79.  
  80. Finally, dmake looks for the file startup.mk in
  81. "{MPW}tools:{DMSTARTUPDIR}".  "DMSTARTUPDIR" can be defined if you
  82. want to override the default tools directory location.
  83.  
  84. Micah Doyle
  85. micah@leland.Stanford.EDU
  86.